home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / xbmbrows.z / xbmbrows / slib / X11 / xbmbrowser / xbmbrowser.help < prev    next >
Text File  |  1994-09-28  |  4KB  |  88 lines
  1. Help For xbmbrowser, By Ashley Roll                                 Version 3.1
  2.  
  3. xbmbrowser is a program to let you easily manipulate Bitmap and Pixmap files.
  4.  
  5. As you can see (on the window that you called this from), the window is 
  6. divided into four areas, one with the three buttons, the next contains a text
  7. box that contains the current directory, you can use this to change the
  8. directory that is searched for bitmaps. The next one down contains the
  9. name of the last selected Bitmap, and the last contains any Bitmap files
  10. that the program found from the command line arguments. 
  11.  
  12. The fourth section is the most important. If you press and hold mouse button
  13. three down over one of the Bitmap images, then a small menu will popup with
  14. commands that you can use to manipulate the bitmap, The default commands are:
  15.  
  16.  Rename -  Use this to rename / move a Bitmap, you will get a requester asking
  17.            for the new name, once you have typed the new name click on the 
  18.            [Ok] button, or [Cancel] to cancel the rename.
  19.  
  20.  Copy -    Use this to copy a Bitmap, you will get a requester asking for the
  21.            name to copy to, once you have typed the new name click on the
  22.            [Ok] button, or [Cancel] to cancel the copy.
  23.  
  24.  Delete -  Use this to Delete a Bitmap, USE WITH CAUTION!!!, you will get a 
  25.            requester asking if you wish to delete the Bitmap or not, click on
  26.            the [Ok] button and the Bitmap will be removed, or [Cancel] to 
  27.            cancel the Delete.
  28.  
  29.  Edit -    This will fire up a copy of your local Bitmap editor to edit the
  30.            selected Bitmap. (If this is not selectable, then you can not 
  31.            do this - ask your system admin to fix it if you REALLY want to use
  32.            this feature).
  33.  
  34.  xsetroot - This will fire up a copy of the program to set the bitmap as the
  35.             root window decoration.
  36.  
  37.  xsetroot inv - Same as xsetroot, except that the bitmap is inverted (black = 
  38.                 white, etc).
  39.  
  40. However you may have different commands, and you can set up commands for 
  41. yourself - to find out how to do this read the manual page for this program.
  42.  
  43. If all the Bitmaps cannot fit into the bottom window, or you resize the 
  44. window, a scroll bar will appear vertically on the left side of this section
  45. and you can use this to see the hidden Bitmaps.
  46.  
  47. You can (of course) quit the program by pressing the [Quit] button. The 
  48. [Rescan] button will rescan all the bitmaps in the current directory (as 
  49. indicated by the text box), redrawing them, this can be used after you have
  50. edited a bitmap to show what it now looks like.
  51.  
  52. Changing Directories:
  53.  
  54. All that you have to do to change the current directory that the program 
  55. searches, is to type the name of the new directory in the text box, and then 
  56. press <Return>. If the directory doesn't exist or you can't access it, then 
  57. the directory will remain unchanged. 
  58.  
  59. You can also press and hold the right mouse button in the directory name 
  60. text box and you will get a menu of directories that you can select. These are
  61. all the subdirectories of the currect directory as well as your home directory
  62. (~/) and the root directrory (/). NOTE - if you don't have access to a 
  63. directory in the list, then you will remain in the current directory.
  64.  
  65. NOTE: you can use '.' and '..' and '~' in your path as the program changes 
  66. directory relative to the current directory, also note that the window will 
  67. always contain the FULL path of the current directory.
  68.  
  69. ******************************************************************************
  70. ** (c) Copyright Ashley Roll, 1992.
  71. ** xbmbrowser is Public Domain. However it, and all the code still belong to me.
  72. ** I do, however grant permission for you to freely copy and distribute it on 
  73. ** the condition that this and all other copyright notices remain unchanged in 
  74. ** all distributions.
  75. **
  76. ** This software comes with NO warranty whatsoever. I therefore take no
  77. ** responsibility for any damages, losses or problems that the program may
  78. ** cause.
  79. ******************************************************************************
  80.  
  81. I must thank Anthony Thyssen for beta testing XbmBrowser and coming up with
  82. the original idea for it. He has also now programmed the color pixmap
  83. viewing code.
  84.  
  85. I must also thank Chris McDonald of the University of Western Australia's 
  86. Department of Computer Science, who provided me with a procedure to expand
  87. ~'s in a directory name.
  88.